IRIX Base Documentation 2001 May

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / cosmocreate.z / cosmocreate

Wrap

Text File | 2001-04-17 | 19.9 KB | 331 lines

CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) NNNNAAAAMMMMEEEE cosmocreate - WYSIWYG HTML authoring tool SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ccccoooossssmmmmooooccccrrrreeeeaaaatttteeee [ X toolkitoption... ] [----ddddeeeeffffaaaauuuullllttttvvvviiiissssuuuuaaaallll] [----eeeemmmmaaaaccccssss] [----hhhheeeellllpppp] [----rrrruuuunnnnmmmmaaaannnnyyyy] [----wwwwaaaarrrrnnnn] [----ssssoooouuuurrrrcccceeeelllliiiinnnneeee ##] [HTML files...] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _c_o_s_m_o_c_r_e_a_t_e is a WYSIWYG editor for creating HyperText Markup Language (HTML) documents for publishing on the World Wide Web (WWW). Through its WYSIWYG interface and its tight integration with the IRIX Interactive Desktop, _c_o_s_m_o_c_r_e_a_t_e greatly simplifies the task of creating compelling HTML documents. The _c_o_s_m_o_c_r_e_a_t_e program contains extensive online help and users guide. For this reason, this man page will not go into detail on the interactive aspects of the program. Please read the Cosmo Create online User's Guide available from the _c_o_s_m_o_c_r_e_a_t_e help menu. This manual page supplements the online help by providing information on the configuration and administration of _c_o_s_m_o_c_r_e_a_t_e. EEEEddddiiiittttoooorrrr KKKKeeeeyyyy BBBBiiiinnnnddddiiiinnnnggggssss The default _c_o_s_m_o_c_r_e_a_t_e key bindings are those used by the Motif XmText widget. In addition, the menu accelerators obey the _I_R_I_X _I_n_t_e_r_a_c_t_i_v_e _U_s_e_r _I_n_t_e_r_f_a_c_e _G_u_i_d_e_l_i_n_e_s and use the Ctrl key. Specifying the ----eeeemmmmaaaaccccssss command-line option runs _c_o_s_m_o_c_r_e_a_t_e using a subset of the Emacs editor key bindings. In Emacs mode, the menu accelerators use the Alt key instead of the Ctrl key. RRRReeeeuuuussssiiiinnnngggg tttthhhheeee EEEEddddiiiittttoooorrrr Normally a single copy of the _c_o_s_m_o_c_r_e_a_t_e program runs and multiple editing windows are opened from that single copy. If a copy of _c_o_s_m_o_c_r_e_a_t_e is already running, attempting to execute a another copy of the program will simply open a new editing window on the original copy of the program. If a file was specified when attempting to run the additional copy of the program, that file will be opened for editing in the new editing window on the original copy of the program. This behavior is called _r_u_n _o_n_c_e. Though it is discouraged, multiple copies of _c_o_s_m_o_c_r_e_a_t_e can be run by specifying ----rrrruuuunnnnmmmmaaaannnnyyyy on the command-line of each additional copy of the program. Note that each copy of the program will display its own set of tool palettes. CCCCoooolllloooorrrrmmmmaaaappppssss aaaannnndddd VVVViiiissssuuuuaaaallllssss By default, _c_o_s_m_o_c_r_e_a_t_e tries to run in 24-bit mode. This mode provides the best color reproduction for images and allocates a very small number of colors from the default system colormap. If 24-bit mode is not available on the system or the ----ddddeeeeffffaaaauuuullllttttvvvviiiissssuuuuaaaallll command-line option is specified, the default visual mode (typically 8-bit) will be used. The use of this mode produces dithered images and may allocate a large number of colors from the default system colormap. PPPPaaaaggggeeee 1111 CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) FFFFiiiilllleeee BBBBaaaacccckkkkuuuupppp aaaannnndddd CCCChhhheeeecccckkkkppppooooiiiinnnnttttiiiinnnngggg By default, _c_o_s_m_o_c_r_e_a_t_e creates a backup file of your original document when you first save any changes to the document. This backup file has the same name as the original file with ._b_a_k appended and is created in the same directory as the original file. In addition to backup files, _c_o_s_m_o_c_r_e_a_t_e creates a checkpoint file every 2 minutes by default. If the editor should exit unexpectedly before the current document has been saved, the checkpoint file provides a recent copy of the edited file and image maps, if any. The checkpoint interval can be changed using the program preferences dialog. Checkpoint files have a ._s_a_v suffix. If a new document has never been saved, the checkpoint file is called _C_o_s_m_o_C_r_e_a_t_e-uuuusssseeeerrrrnnnnaaaammmmeeee-iiiidddd._s_a_v. If the document has been saved, the checkpoint file is called ffffiiiilllleeeennnnaaaammmmeeee-uuuusssseeeerrrrnnnnaaaammmmeeee-iiiidddd._s_a_v. Checkpoint files are normally created in the same directory as the current file. If a checkpoint file cannot be saved in the current directory, an attempt is made to save it in /_v_a_r/_t_m_p. Checkpoint files are automatically deleted when _c_o_s_m_o_c_r_e_a_t_e terminates normally. FFFFoooonnnnttttssss In keeping with the spirit of a markup language, _c_o_s_m_o_c_r_e_a_t_e users do not specify font names and sizes directly. Font name and size are determined by the paragraph style and font style selected for a portion of text. Paragraph and font styles are mapped to actual font names and sizes in the application resource file /_u_s_r/_l_i_b/_X_1_1/_a_p_p-_d_e_f_a_u_l_t_s/_C_o_s_m_o_C_r_e_a_t_e. The font names and sizes have been chosen to closely match those used by common Web browsers such as Netscape. Users may choose among three font set sizes: small, medium (default), and large. To select a font set size, set the _C_o_s_m_o_C_r_e_a_t_e*_f_o_n_t_S_i_z_e_P_r_e_f_e_r_e_n_c_e resource to one of ssssmmmmaaaallllllll, mmmmeeeeddddiiiiuuuummmm, or llllaaaarrrrggggeeee. You can specify individual font names and sizes within each font set. However, doing this may compromise the WYSIWYG nature of _c_o_s_m_o_c_r_e_a_t_e. The Courier font is substituted for any font that is not available on the system. CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn FFFFiiiilllleeeessss _c_o_s_m_o_c_r_e_a_t_e places configuration files in a directory called ._c_o_s_m_o_c_r_e_a_t_e. One of these configuration files, _c_o_s_m_o_c_r_e_a_t_e-_p_r_e_f_e_r_e_n_c_e_s contains user preference settings. The file is an ASCII text file and contains comments describing its contents. On startup, _c_o_s_m_o_c_r_e_a_t_e first checks the environment for the CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE____CCCCOOOONNNNFFFFIIIIGGGGDDDDIIIIRRRR variable. If this variable is set, its value is the full pathname of the configuration file directory. If the environment variable is not set, _c_o_s_m_o_c_r_e_a_t_e next looks for a configuration file directory called ._c_o_s_m_o_c_r_e_a_t_e in the current working directory. If the directory is not found, the program looks for it in the user's home directory. By placing a copy of the ._c_o_s_m_o_c_r_e_a_t_e directory in your project root directory, you can customize the program preferences for that project. PPPPaaaaggggeeee 2222 CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) If _c_o_s_m_o_c_r_e_a_t_e does not find a ._c_o_s_m_o_c_r_e_a_t_e directory but does find a ._w_e_b_m_a_g_i_c-_p_r_e_f_e_r_e_n_c_e_s file in a given directory, that file will be used and renamed to ._c_o_s_m_o_c_r_e_a_t_e/_c_o_s_m_o_c_r_e_a_t_e-_p_r_e_f_e_r_e_n_c_e_s. AAAAddddddddiiiinnnngggg WWWWeeeebbbb BBBBrrrroooowwwwsssseeeerrrrssss The list of Web browsers available for previewing the current page is user extensible. To edit the list of Web browsers select the BBBBrrrroooowwwwsssseeeerrrrssss category on the Preferences dialog. The _N_a_m_e is the common name of the browser (e.g. Netscape). The name should not contain any whitespace. The _P_a_t_h_n_a_m_e is the absolute or relative pathname of the browser. If a pathname is provided without a leading path, the PPPPAAAATTTTHHHH will be searched to find the file. The browser can be set to be the preferred browser using the toggle button. The _C_o_m_m_u_n_i_c_a_t_i_o_n _M_e_t_h_o_d specifies how _c_o_s_m_o_c_r_e_a_t_e is to tell the browser to load a new file. Depending on the communication method specified, a communication port number may be required. Consult your browser documentation or your system administrator for the correct communication port number. The _c_o_n_t_r_o_l _p_a_r_a_m_s depend on the control method selected. The following communication methods are available: NNNNoooonnnneeee The browser cannot be remote controlled. Each time the current page is previewed, a new copy of the browser will be run. TTTTeeeexxxxtttt OOOOnnnnllllyyyy The browser cannot be remote controlled and requires a TTY terminal shell. The Lynx browser is a typical example of this type of browser. Each time the current page is previewed, a new window shell running the browser will be run. NNNNeeeettttssssccccaaaappppeeee This method is used to control the Netscape Navigator version 2.0 and higher. The method uses the -_r_e_m_o_t_e command line argument to control the browser and provides workarounds for bugs in remote control viewing with FRAMESETs. NNNNeeeettttssssccccaaaappppeeee 1111....1111 This method is used to control the Netscape Navigator version 1.1. The method uses the -_r_e_m_o_t_e command line argument to control the browser. NNNNeeeettttssssccccaaaappppeeee 1111....0000 This method is used to control the Netscape Navigator version 1.0. The method is identical to the NNNNOOOONNNNEEEE method since the 1.0 version of the Netscape Navigator did not support remote control. MMMMoooossssaaaaiiiicccc UUUUSSSSRRRR1111 This method is used to control older versions of the NCSA Mosaic browser. The method issues the signal SSSSIIIIGGGGUUUUSSSSRRRR1111 to control the browser. PPPPaaaaggggeeee 3333 CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) MMMMoooossssaaaaiiiicccc CCCCCCCCIIII This method is used to control current versions of the NCSA Mosaic browser. The method uses the Common Client Interface protocol to control the browser. This method requires one control parameter. The parameter is an integer between 1024 and 65535 and is used as the TCP/IP port number for communication between _c_o_s_m_o_c_r_e_a_t_e and the Web browser. MMMMoooossssaaaaiiiicccc SSSSDDDDIIII This method is used to control the Spyglass version of the Mosaic browser. The method uses the Software Development Interface protocol to control the browser. This method requires one control parameter. The parameter is an integer between 1024 and 65535 and is used as the TCP/IP port number for communication between _c_o_s_m_o_c_r_e_a_t_e and the Web browser. NNNNOOOOTTTTEEEE:::: Certain versions of Spyglass' eMosaic browser are actually launched from a shell script called eMosaic. Due to a bug in that shell script the browser cannot be launched from _c_o_s_m_o_c_r_e_a_t_e unless the following line is added to the top of the script: ####!!!! ////bbbbiiiinnnn////sssshhhh. Browsers that cannot be found will be displayed greyed out in _c_o_s_m_o_c_r_e_a_t_e. The control methods tend to be browser specific. Check with your browser vendor to determine which control method is applicable. At a minimum the NNNNoooonnnneeee method will always work at the cost of cluttering up the screen with multiple copies of the browser. CCCChhhhaaaannnnggggiiiinnnngggg SSSSoooouuuurrrrcccceeee EEEEddddiiiittttiiiinnnngggg PPPPrrrreeeeffffeeeerrrreeeennnncccceeeessss The tab stops and colors used in the View/Edit Source window can be changed by editing the _c_o_s_m_o_c_r_e_a_t_e-_p_r_e_f_e_r_e_n_c_e_s file (see CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn FFFFiiiilllleeeessss above). To create a preferences file select Save from the Preferences dialog. The tab stop preference has the name _s_o_u_r_c_e_T_a_b_S_t_o_p and the color preferences have the name _s_o_u_r_c_e<_t_y_p_e>_C_o_l_o_r. Colors can be specified as HTML color names (e.g. red, green, etc.) or as #RRGGBB values. HHHHTTTTMMMMLLLL PPPPaaaarrrrsssseeeerrrr WWWWaaaarrrrnnnniiiinnnnggggssss By default _c_o_s_m_o_c_r_e_a_t_e does not display warnings from the HTML parser. There are two ways to configure _c_o_s_m_o_c_r_e_a_t_e to display parser warnings. The first method is to turn on warnings using the program preferences dialog. The second method is to specify ----wwwwaaaarrrrnnnn on the command-line. Specifying ----wwwwaaaarrrrnnnn overrides any saved preference for warnings. Specifying the Xt resource ****sssshhhhoooowwwwWWWWaaaarrrrnnnniiiinnnnggggssss:::: TTTTrrrruuuueeee is equivalent to -warn. SSSSttttaaaarrrrttttiiiinnnngggg SSSSoooouuuurrrrcccceeee LLLLiiiinnnneeee The ----ssssoooouuuurrrrcccceeeelllliiiinnnneeee option attempts to position the insertion point in the WYSIWYG editing window on a line corresponding to the HTML source file line number specified. The correspondence of the insertion point to the HTML source line is approximate and can be off by a line under certain circumstances. Specificying the Xt resource ****ssssoooouuuurrrrcccceeeeLLLLiiiinnnneeee:::: ######## is equivalent to -sourceline. PPPPaaaaggggeeee 4444 CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111)))) LLLLiiiinnnnkkkk GGGGeeeennnneeeerrrraaaattttiiiioooonnnn CCCCoooommmmmmmmaaaannnndddd TTTTiiiimmmmeeeeoooouuuutttt By default, the command used to generate a link must complete within 30 seconds or the command will timeout. If 30 seconds is insufficient, the timeout can be changed using the Xt resource ****ccccmmmmddddTTTTiiiimmmmeeeeoooouuuutttt:::: ######## where ######## is the number of seconds for the timeout. FFFFIIIILLLLEEEESSSS /usr/sbin/CosmoCreate Program executable /usr/sbin/cosmocreate Link to CosmoCreate /usr/sbin/webmagic Link to CosmoCreate /usr/lib/X11/app-defaults/CosmoCreate Program resource file $HOME/.spelling Personal spelling dictionaries $HOME/.cosmocreate Program configuration file directory ./.cosmocreate Program configuration file directory .cosmocreate/cosmocreate-preferences User preferences file .cosmocreate/cosmocreate-layout User layout preferences for editing window, palettes, toolbars, etc. /usr/share/Cosmocreate/templates HTML template directory /var/tmp Fallback location for checkpoint files *.bak Backup file *.sav Checkpoint file SSSSEEEEEEEE AAAALLLLSSSSOOOO Cosmo Create online help and user's guide, netscape(1) PPPPaaaaggggeeee 5555